home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / sunclock / sunclock.doc < prev    next >
Text File  |  1995-05-25  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4.      SSSSUUUUNNNNCCCCLLLLOOOOCCCCKKKK((((GGGG))))              UUUUNNNNIIIIXXXX VVVV               SSSSUUUUNNNNCCCCLLLLOOOOCCCCKKKK((((GGGG))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           sunclock - show illuminated portion of Earth
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.           ssssuuuunnnncccclllloooocccckkkk [ _o_p_t_i_o_n_s ]
  13.  
  14.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.           _s_u_n_c_l_o_c_k is an X11 application that displays a map of the
  16.           Earth and indicates the illuminated portion of the globe by
  17.           drawing sunlit areas dark on light, night areas as light on
  18.           dark.  It also displays the current date and time.
  19.  
  20.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  21.           The program does not use the X Toolkit, and hence only those
  22.           options explicitly enumerated below may be used.  Neither
  23.           are any resources used.
  24.  
  25.           ----vvvveeeerrrrssssiiiioooonnnn
  26.                Show program version and patch level, and then exit.
  27.  
  28.           ----ddddiiiissssppppllllaaaayyyy _d_i_s_p_n_a_m_e
  29.                Give the name of the X server to contact.
  30.  
  31.           ----iiiiccccoooonnnniiiicccc
  32.                Start iconic.  Usually you will want to specify this
  33.                option.
  34.  
  35.           ----ggggeeeeoooommmmeeeettttrrrryyyy +_x+_y
  36.                Specify the position of the window.  Only the position
  37.                is used; any size information given is ignored.
  38.  
  39.           ----iiiiccccoooonnnnggggeeeeoooommmmeeeettttrrrryyyy +_x+_y
  40.                Specify the position of the icon.  Only the position is
  41.                used; any size information given is ignored.
  42.  
  43.      HHHHOOOOWWWW IIIITTTT WWWWOOOORRRRKKKKSSSS
  44.           _s_u_n_c_l_o_c_k calculates the position of the Sun using the
  45.           algorithm in chapter 18 of:
  46.  
  47.           _A_s_t_r_o_n_o_m_i_c_a_l _F_o_r_m_u_l_a_e _f_o_r _C_a_l_c_u_l_a_t_o_r_s by Jean Meeus, Third
  48.           Edition, Richmond: Willmann-Bell, 1985.
  49.  
  50.           and Mercator projects the illuminated area onto map image.
  51.           The Sun's position is calculated to better than one arc-
  52.           second in accuracy.
  53.  
  54.      BBBBUUUUGGGGSSSS
  55.           The maps are not rescaled if you resize the open window or
  56.           icon.  (I don't want to have to store a vector database for
  57.           the map.)  The program contravenes section 4.1.9 of the
  58.           ICCCM in that its icon window is a fixed size, and any
  59.           WM_ICON_SIZE property of the root window is ignored.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 2/21/91)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      SSSSUUUUNNNNCCCCLLLLOOOOCCCCKKKK((((GGGG))))              XXXXEEEENNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV               SSSSUUUUNNNNCCCCLLLLOOOOCCCCKKKK((((GGGG))))
  71.  
  72.  
  73.  
  74.           The illuminated area shown is the area which would be sunlit
  75.           if the Earth had no atmosphere.  The actual illuminated area
  76.           is larger because of atmospheric refraction and twilight.
  77.  
  78.      AAAAUUUUTTTTHHHHOOOORRRR
  79.           John Mackin, Basser Department of Computer Science,
  80.           University of Sydney, Sydney, Australia; <john@cs.su.oz.AU>.
  81.           Based on a Suntools program by John Walker, Autodesk, Inc.;
  82.           <kelvin@acad.uu.NET>.
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 2/21/91)
  130.  
  131.  
  132.  
  133.